跳到主要内容

滚动 UI 元素或当前页面 (ui_element.scroll)

该函数在 20260507 以后版本方可使用

声明​

状态, 信息或错误信息 = ui_element.scroll(方向 [, 选项 ])
状态, 信息或错误信息 = ui_element.scroll(选择器或元素, 方向 [, 选项 ])

参数​

  • 选择器或元素
    可选参数,表型,可以是 选择器、查询返回的元素,或 { x = 横坐标, y = 纵坐标 } 坐标表。
  • 方向
    文本型,支持 "down"、"up"、"left"、"right"、"top"、"bottom"。
  • 选项
    可选参数,表型。可使用 point、x、y 指定命中点,也可使用 steps 指定步进参数。

返回值​

  • 状态
    布尔型,成功时为 true,失败时为 nil。
  • 信息或错误信息
    成功时为表型动作信息,失败时为文本型错误原因。

说明​

不传选择器时,默认尝试滚动当前页面。 传入选择器时,会尝试滚动目标元素所在的可滚动区域。 如果需要确定滚动多页,建议在 Lua 脚本中循环调用并自行检查页面变化。

示例​

local ui_element = require("ui_element")

ui_element.scroll("down", {
point = { x = 200, y = 700 },
})

ui_element.scroll({
text_contains = "列表",
}, "up")